home *** CD-ROM | disk | FTP | other *** search
/ Brotikasten / BROTCD01.iso / c128 / c120.d64 / gds docs.txt < prev    next >
Text File  |  1995-08-09  |  11KB  |  248 lines
  1.                   ╟╥┴╨╚╔├╙ ╔╬╘┼╥├╚┴╬╟┼ ╞╧╥═┴╘ ─╔╙╨╠┴┘ ╙┘╙╘┼═
  2.  
  3.  
  4. ├OPYRIGHT ╬OTICES AND OTHER SUCH STUFF....
  5.  
  6. '╟╔╞' AND '╟RAPHICS ╔NTERCHANGE ╞ORMAT' ARE TRADEMARKS OF ├OMPU╙ERVE, ╔NC., AN
  7. ╚&╥ ┬LOCK ├OMPANY. (YOU KNOW... THE GUYS WHO YOU GIVE MONEY TO FOR TELLING YOU
  8. HOW MUCH MONEY YOU WILL GIVE TO THE ╟OVERNMENT.)
  9.  
  10. ┬┴╙╔├ 8 IS A TRADEMARK OF ╫ALRUS ╙OFTWARE, ╔NC.
  11.  
  12. ╘HE ╟RAPHICS ╔NTERCHANGE ╞ORMAT ─ISPLAY ╙YSTEM, OR ╟╔╞ ─ISPLAY ╙YSTEM FOR
  13. SHORT, OR BETTER YET - ╟─╙ (MAINLY BECAUSE IT'S CATCHY, BUT ALSO BECAUSE ╔
  14. REALLY DON'T WANT TO TYPE OUT THE WHOLE THING), IS ╬╧╘ ╨UBLIC ─OMAIN.  ╘HIS
  15. PROGRAM CANNOT BE SOLD WITHOUT THE EXPRESS WRITTEN CONSENT OF THE AUTHOR (ME).
  16. ╘HIS PROGRAM MAY BE DISTRIBUTED FREELY AS LONG AS ALL ORIGINAL FILES ARE
  17. INCLUDED WITH IT.
  18.  
  19. ╟─╙ FALLS UNDER THE CATEGORY OF ╞╥┼┼╫┴╥┼.  ┴LL ╔ WANT FOR THIS IS THE FAME,
  20. GLORY, RECOGNITION, AND POSTCARDS.  ┘EP, YOU READ RIGHT! ╨╧╙╘├┴╥─╙.  ╔ KINDA
  21. COLLECT POSTCARDS, AND ╔ WOULD ALSO LIKE TO SEE HOW FAR THIS PROGRAM GETS
  22. DISTRIBUTED.  ╙O IF YOU USE THIS PROGRAM REGULARLY, YOU ARE OBLIGATED TO SEND
  23. ME A POSTCARD.  ╔ GUESS YOU CAN CALL THIS ╨╧╙╘├┴╥─╫┴╥┼!!!!!
  24. ╨LEASE SEND EVERYTHING YOU WANT TO SEND ME TO:
  25.  
  26.                              ┼RIC ├. ╥AFANAN
  27.                              ╨.╧. ┬OX 1428
  28.                              ─UNNELLON, ╞╠ 32630
  29.  
  30. ╘HIS INCLUDES POSTCARDS, COMMENTS, PICTURES FROM CUTE GIRLS, OFFERS FOR ├┼╧
  31. POSITIONS (ONLY FROM PROMINENT COMPANIES PLEASE), OR BETTER YET - ╟╔╞S! ╔ ONLY
  32. HAVE A SMALL COLLECTION AND ┴╬┘╘╚╔╬╟ (YES - ┴╬┘╘╚╔╬╟) WOULD BE APPRECIATED.
  33.  
  34. ┴NYWAY, ON WITH THE DOCS...
  35.  
  36.  
  37. ╟╔╞ ─ISPLAY ╙YSTEM
  38.  
  39.  
  40. ┴FTER USING THE ╟╔╞╞┘ PROGRAM FOR THE ├64 BY ╩OHN ╥. ╫IND, ╔ WAS IMPRESSED. ╔
  41. ALSO THOUGHT THAT ANYTHING THE ├64 CAN DO, THE ├128 CAN DO BETTER. ╙O ╔ SET OUT
  42. TO WRITE A ├128 ╟╔╞ ─ISPLAY PROGRAM THAT WAS EASIER TO USE, YET PRODUCED BETTER
  43. DISPLAYS.
  44.  
  45. ╙O HERE IT IS.
  46.  
  47. ╘HE PROGRAM ACTUALLY CONSISTS OF SEVERAL FILES:
  48.  
  49. 1) ╟─╙          - ╘HIS IS THE ═AIN ═ODULE OF THE ╟─╙ PROGRAM.
  50.                   ╔T LOADS IN THE 2 SUPPORT MODULES, HANDLES THE CHOOSING OF
  51.                   THE ╟╔╞, THE INTERPRETATION OF THE ╟╔╞ HEADER, AND THE ACTUAL
  52.                   DECOMPRESSION OF THE COMPRESSED RASTER DATA.
  53.  
  54. 2) ╟─╙.─┼╞┴╒╠╘╙ - ╘HIS FILE CONTAINS THE NAMES OF THE DEFAULT SUPPORT MODULES.
  55.  
  56. 3) ╟─╙.─/????   - ╞ILES WITH THIS PREFIX ARE ─ISPLAY ═ODULE FILES.
  57.                   ╟─╙ WAS WRITTEN TO BE MODULAR TO ALLOW DIFFERENT DISPLAY
  58.                   FORMATS TO BE USED.
  59.  
  60. 4) ╟─╙.╪/????   - ╞ILES WITH THIS PREFIX ARE ┼XTENSION ╚ANDLER ═ODULES.
  61.                   ╟╔╞ FILES HAVE THE OPTION TO INCLUDE 'UPDATES' IN THE FORM
  62.                   OF ┼XTENSION ┬LOCKS, AND THE ┼XTENSION ╚ANDLER ═ODULE TAKES
  63.                   CARE OF THESE BLOCKS.
  64.  
  65. ==============================================================================
  66.  
  67. ╘HE ═AIN ═ODULE
  68.  
  69. ╘HE ╟─╙ PROGRAM HAS BEEN WRITTEN FOR EASE OF USE. ┴LMOST EVERYTHING CAN BE DONE
  70. THROUGH THE USE OF MENUS.
  71.  
  72. ╒SE THE ├URSOR ╦EYS TO HIGHLIGHT A CHOICE.
  73. ╒SE THE ╥ETURN ╦EY TO PICK IT.
  74. ╒SE THE ┼╙├ ╦EY TO ABORT ALMOST ANYTHING (THE PROGRAM WILL TELL YOU WHEN IT
  75. DOES SOMETHING ELSE).
  76.  
  77. ═OST OF THE MENUS ARE SELF-EXPLANATORY, SO ╔ WILL ONLY COVER THOSE AREAS THAT
  78. MAY NEED A LITTLE MORE CLARIFICATION.
  79.  
  80. ╘HE ═AIN ═ENU HAS 3 CHOICES:
  81.  
  82. 1) ╓IEW A ╟╔╞    - ┴LLOWS YOU TO VIEW A ╟╔╞ ON ─RIVES 8, 9, 10, OR 11.
  83.                    ┘OU CHOOSE THE ╟╔╞ FROM A ─IRECTORY LISTING.
  84.                    ╬╧╘┼ - ╟╔╞S MUST BE ╨ROGRAM, ╙EQUENTIAL, OR ╒SER (THOUGH
  85.                           NON-╟┼╧╙) TYPE FILES.
  86.  
  87. 2) ┼XIT          - ╨RETTY SELF-EXPLANATORY.
  88.  
  89. 3) ╙ELECT ═ODULE - ┴LLOWS YOU TO SELECT ANOTHER ─ISPLAY ═ODULE OR ┼XTENSION
  90.                    ═ODULE FROM ─RIVES 8, 9, 10, OR 11.
  91.                    ┴LSO MAKES IT THE ─EFAULT ═ODULE AS AN OPTION.
  92.                    ╬╧╘┼ - ╫HEN YOU WRITE A NEW ─EFAULTS FILE, BOTH THE ├URRENT
  93.                           ─ISPLAY ┴╬─ ┼XTENSION ═ODULES ARE MADE THE ─EFAULTS.
  94.  
  95. ┴LL THE SECONDARY MENUS ARE ╥┼┴╠╠┘ SELF-EXPLANATORY (┘┼╙/╬╧, ├HOOSE A ─RIVE,
  96. ETC.) SO ╔ DON'T THINK ╔ NEED TO GO INTO THEM (AFTER ALL, IF YOU OWN A ├128,
  97. THEN YOU'VE ╟╧╘ TO HAVE ABOVE AVERAGE INTELLIGENCE!).
  98.  
  99.  
  100. ╘HE ╙CREEN ╠AYOUT
  101.  
  102.  
  103. ╘HE ╙CREEN IS DIVIDED INTO 3 PARTS:
  104.  
  105. 1) ├REDIT ┬LOCKS - ╘HIS IS THE UPPER HALF OF THE SCREEN. ╘HE TWO SMALLER BLOCKS
  106.                    ARE CREDITS READ FROM THE ═ODULES (SO IF YOU'RE WILLING TO
  107.                    PROGRAM A ═ODULE, YOU CAN LET PEOPLE KNOW WHO DID IT! ╔T'S
  108.                    ONLY FAIR AFTER ALL.).
  109.  
  110. 2) ╟╔╞ ╔NFO      - ╘HE LOWER LEFT PORTION OF THE SCREEN IS USED TO DISPLAY
  111.                    INFORMATION ABOUT THE ╟╔╞ YOU HAD CHOSEN.  ═OST OF IT NEEDS
  112.                    NO EXPLANATION, BUT HERE'S ONE THING TO WATCH OUT FOR -
  113.                    ╔ BELIEVE THERE HAS BEEN AN UPDATE TO THE ╟╔╞ FORMAT. ╔T
  114.                    HAS BEEN LABELED '╟╔╞89A'.  ╟─╙ RECOGNIZES ANY ╟╔╞ WITH THE
  115.                    '╟╔╞' SIGNATURE, BUT IT ═┴┘ NOT PROCESS '89A' TYPE ╟╔╞S
  116.                    CORRECTLY.  ═OST ╟╔╞S ARE CURRENTLY '╟╔╞87A'.
  117.  
  118. 3) ═ESSAGE ┴REA  - ╘HE LOWER RIGHT PORTION OF THE SCREEN IS THE ═ESSAGE ┴REA.
  119.                    ╘HIS IS WHERE MOST (IF NOT ALL) USER INTERACTION WILL TAKE
  120.                    PLACE.
  121.  
  122.  
  123. ┴ND THAT'S ALL THERE IS TO IT!
  124.  
  125. ==============================================================================
  126.  
  127. ╟ETTING ╘HIS ╘HING ╥UNNING
  128.  
  129.  
  130. ╘HE BASIC STEPS TO USING THIS PROGRAM ARE:
  131.  
  132. ╥╒╬ "╟─╙" ╧╬ ╒(WHATEVER)
  133.   (IT WILL LOAD, RUN, THEN LOAD IN THE ─EFAULT ═ODULES FROM THE ├URRENT ─RIVE)
  134.  
  135. ├HOOSE '╓IEW A ╟╔╞' FROM THE ═AIN ═ENU.
  136.  
  137. ╨ICK THE ─RIVE THE ╟╔╞S ARE ON.
  138.   (IT WILL THEN READ IN ALL FILENAMES WITH THE '.╟╔╞' SUFFIX)
  139.  
  140. ╚IGHLIGHT AND ├HOOSE THE ╟╔╞ YOU WANT TO VIEW.
  141.  
  142. ├ONFIRM YOUR ╙ELECTION.
  143.   (YOU CAN ABORT IF ALL YOU WANTED TO DO WAS LOOK AT THE ╟╔╞ INFO)
  144.  
  145. ┴ND AWAY IT GOES!!!
  146.  
  147. ==============================================================================
  148.  
  149. ╘HE ─ISPLAY ═ODULE
  150.  
  151.  
  152. ╘HE ─ISPLAY ═ODULE IS THE PART OF THE SYSTEM THAT (YOU GUESSED IT!) ACTUALLY
  153. DISPLAYS THE ╟╔╞.  ╔T ALSO IS RESPONSIBLE FOR DOING THE COLOR TRANSLATIONS.
  154. ╔ CHOSE TO MAKE IT A MODULE SO THAT DIFFERENT FORMATS COULD BE CHOSEN WITHOUT
  155. ACTUALLY REWRITING THE ENTIRE PROGRAM.  ╘HESE FORMATS CAN INCLUDE 40-COLUMN
  156. ╚I-╥ES AND ═ULTICOLOR GRAPHICS SCREENS, ┬ASIC 8 FORMATS, THE ╔╨AINT FORMAT, OR
  157. EVEN CUSTOM MADE FORMATS.  ┴LL IT TAKES IS THE CORRECT ─ISPLAY ═ODULE.
  158.  
  159. ╘HE ═AIN ═ODULE TAKES CARE OF EVERYTHING (INCLUDING DECOMPRESSING THE RASTER
  160. DATA - THAT WAS A TOUGHIE!) EXCEPT ACTUALLY PUTTING THE PICTURE ON THE SCREEN,
  161. SO IT'S NOT HARD TO COME UP WITH A NEW ─ISPLAY ═ODULE.  ╞OR ANY PROGRAMMERS WHO
  162. ARE INTERESTED, ╔ WILL BE UPLOADING ╨ROGRAMMING ╬OTES '╥EAL ╙OON ╬OW'. (╞AMOUS
  163. ╠AST ╫ORDS!)
  164.  
  165. ╘HERE ARE 3 ─ISPLAY ═ODULES INCLUDED WITH THE ╟─╙ PROGRAM:
  166.  
  167. 1) ╟─╙.─/╬╧╥═┴╠    - ╘HIS IS THE ─EFAULT ═ODULE. ╔T IS SET TO PROVIDE A PRETTY
  168.                      GOOD DISPLAY FOR THE MAJORITY OF THE ╟╔╞S.
  169.  
  170. 2) ╟─╙.─/╠╔╟╚╘┼╥   - ╔F THE ╟╔╞S SEEM TO BE COMING OUT TOO DARK (ALOT OF 256
  171.                      COLOR ╟╔╞S TEND TO), THEN THIS MODULE WILL ATTEMPT TO
  172.                      MAKE THE COLORS BRIGHTER.
  173.  
  174. 3) ╟─╙.─/─┴╥╦┼╥    - ╘HIS MODULE IS SET TO DARKEN THE COLORS IN A ╟╔╞.
  175.  
  176. ┴LL 3 REQUIRE 64╦ OF ╓─├ ╥┴═.
  177.  
  178. ╘HESE ─ISPLAY ═ODULES WERE CODED FOR 16-COLOR ╟╔╞S, BUT 4 AND 32-COLOR ╟╔╞S
  179. STILL SHOW UP PRETTY GOOD.  ╬OW 256-COLOR ╟╔╞S ARE ANOTHER MATTER...
  180.  
  181. ╙INCE THE ├128 HARDWARE ONLY SUPPORTS 16 COLORS, THEN TO GET ANY REASONABLE
  182. DISPLAY OF 256 COLORS REQUIRES SOME FORM OF ╙╧╞╘╫┴╥┼ WORKAROUND, SUCH AS
  183. DITHERING OR INTERLACE (LIKE IN ╔╨AINT - GOSH, ╔ WISH ╔ HAD THE ╔╨AINT
  184. FORMAT!).  ┴NYWAY, THE ─ISPLAY ═ODULES THAT COME WITH THE ╟─╙ PROGRAM ARE
  185. PRETTY SAD WHEN IT COMES TO 256-COLOR ╟╔╞S (AND THAT'S COMING FROM THE PERSON
  186. WHO PROGRAMMED THEM!).
  187.  
  188. ╘HE ─ISPLAY ═ODULES WILL 'STRETCH' OR 'SQUASH' A ╟╔╞ TO FIT INTO THE 640X200
  189. ┬ASIC 8 FORMAT.  ╔T CAN HANDLE ╔NTERLACED ╟╔╞ FILES UP TO A HEIGHT OF 200
  190. LINES.
  191.  
  192. ┴FTER VIEWING THE ╟╔╞, HITTING ANY KEY EXCEPT FOR THE '╙' KEY WILL RETURN YOU
  193. TO THE ═AIN ═ODULE.
  194.  
  195. ╘HE '╙' KEY ALLOWS YOU TO SAVE THE ╟╔╞ AS A 640X200 8X2-COLOR BLOCK ┬ASIC 8
  196. PICTURE.  ┴FTER HITTING THE '╙' KEY, YOU WILL HEAR 2 QUICK BELLS TO NOTIFY YOU
  197. THAT SAVING HAS BEGUN. ╫HEN IT IS DONE, YOU WILL BE RETURNED TO THE ═AIN ═ENU.
  198.  
  199. ╘HE PICTURE WIL